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PREFACE 


About This Manual 


This document describes the .AFPTranslater driver, which was implemented for 
AppleShare IP in order to provide transport independence for fhe AppleTalk 
Filing Protocol. The .AFPTranslafor driver accepfs Plierarchical File System 
(PIPS) and AFP commands from applicafions and sends fhem fo fhe dafa sfream 
inferface or fhe .XPP driver depending on fhe fransporf protocol fhaf fhe 
command uses. 

This documenf replaces Chapter 9 of Inside Macintosh: Networking. 


Conventions Used in This Manual 


The Courier fonf is used fo indicate server confrol calls, code, and fexf fhaf you 
fype. Terms fhaf are defined in fhe glossary appear in boldface af firsf mention 
in fhe fexf. This guide includes special fexf elemenfs fo highlighf imporfanf or 
supplemenfal informafion: 

Note 

Texf sef off in fhis manner presenfs sidelighfs or inferesfing 
poinfs of informafion. ♦ 

IMPORTANT 

Texf sef off in fhis manner—wifh fhe word Imporfanf— 
presenfs imporfanf informafion or insfrucfions. A 

A W/iRNING 

Texf sef off in fhis manner—wifh fhe word Warning— 
indicafes pofenfially serious problems. ▲ 
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For More Information 


The following books provide information that is important for all AppleShare 
developers: 

■ AppleShare IP Administrator's Manual. Apple Computer, Inc. 

■ Inside Macintosh. Apple Computer, Inc. 

For information on the programming interface for managing users and groups, 
see the following publication: 

■ AppleShare IP 6.3 Developer's Kit: AppleShare Registry Library. Apple Computer, 
Inc. 

For additional information on the AppleTalk Filing Protocol (AFP), see the 
following publications: 

■ AppleShare IP 6.3 Developer's Kit: AppleTalk Filing Protocol Version 2.1 and 2.2. 
Apple Computer, Inc. 

■ Inside AppleTalk, Second Edition. Apple Computer, Inc. 

For information on user authentication modules (UAMs), see the following 
publication: 

■ AppleShare IP 6.3 Developer's Kit: User Authentication Modules. Apple 
Computer, Inc. 

For information on AppleShare IP Print Server security mechanisms, see the 
following publication: 

■ AppleShare IP 6.3 Developer's Kit: AppleShare IP Print Server Security Protocol. 
Apple Computer, Inc. 

For information on controlling an AppleShare file server and handling server 
events, see the following publication: 

■ AppleShare IP 6.3 Developer's Kit: Server Control Calls and Server Event Handing. 
Apple Computer, Inc. 
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PREFACE 


For information on using the AppleShare IP File Server 6.3 and Macintosh File 
Sharing, see the following manuals: 

■ AppleShare Client User's Manual. Apple Computer, Inc. 

■ Macintosh Networking Reference. Apple Computer, Inc. 
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CHAPTER 1 


AppleTalk Filing Protocol (AFP) 


This chapter describes the AppleTalk Filing Protocol (AFP) that allows a 
workstation on an AppleTalk network to access and manipulate files on an AFP 
file server, such as an AppleShare server. 

Because you can use fhe native file sysfem fo access an AFP server from a 
worksfafion, in mosf cases you should nof need fo use AFP direcfly For 
example, few applicafion developers use AFP fo access an AppleShare file 
server because fhe exisfing File Manager commands perform mosf of fhe 
functions needed fo access and manipulafe files on an AppleShare server. 

However, if you wanf fo provide funcfions fhaf are nof implemenfed by fhe 
nafive file sysfem commands or you wanf fo manipulafe files on an AFP server 
ofher fhan an AppleShare server, your applicafion can use fhe AFP 
programming inferface fo direcfly access AFP fo send commands fo fhe server. 
For example, you can use AFP fo lisf fhe confenfs of a direcfory when you need 
fo obfain ProDOS information. You can also use AFP fo refrieve or sef 
paramefers for a specific file when ProDOS is used. 

This chapfer describes fhe programming inferface fo fhe worksfafion porfion of 
AFP only. If does nof describe how fo implemenf an AFP server. For 
informafion on how fo implemenf an AFP server, see Inside AppleTalk, second 
edifion. 

Because AFP is nof widely used by applicafion program developers, fhis 
chapfer provides only fhe AFP basics. This chapfer includes an " Abouf" and 
"Reference" secfions. If does nof include a "Using" section, as do mosf of fhe 
ofher chapfers in fhis book. This chapfer is included in fhis book fo complefe fhe 
coverage of fhe AppleTalk protocol slack. 

If you decide fo use AFP, if is imporfanf fo nofe fhaf fo implemenf an AFP 
command, you need informafion in addifion fo fhe informafion fhaf fhis 
chapfer provides. Inside AppleTalk, second edifion, and fhe AppleShare IP 6.3 
Developer's Kit, provide informafion describing fhe AFP commands and fhe 
command block dafa sfrucfure required for each command. The AppleShare IP 
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IP 6.3 Developer's Kit includes extensions to AFP not described in Inside 
AppleTalk. 

AFP is built on top of the AppleTalk Session Protocol (ASP) and uses the 
services of ASP. To use AFP, you should also be familiar wifh ASP, which is 
described in fhe chapfer "AppleTalk Session Profocol (ASP)" in fhis book. For 
an overview of AFP and how if fifs wifhin fhe AppleTalk profocol slack, read 
fhe chapfer "Infroducfion fo AppleTalk," in Inside Macintosh: Networking. 


About AFP 


AFP is a remofe filing sysfem profocol fhaf provides a worksfafion on a nefwork 
wifh access fo a server fhaf is implemenfed according fo fhe AFP file sysfem 
sfrucfure. AFP also includes user aufhenficafion supporf and an access confrol 
mechanism fhaf supporfs volume-level and folder-level access righfs. 
AppleShare is fhe AFP file server fhaf is implemenfed on Macinfosh compufers. 

Through fhe native file sysfem and AFP, your application running on one node 
can manipulafe files on anofher node using fhe same file sysfem commands on 
fhe remofe node fhaf if uses fo manipulafe files on ifs own node. You can use 
AFP commands fo 

■ obfain and modify informafion abouf fhe file server and ofher parfs of fhe file 
sysfem sfrucfure 

■ creafe and delefe files and directories 

■ read files or wrife fo fhem 

■ refrieve and store informafion wifhin individual files 

The .AFPTranslafor driver allows fhe worksfafion fo access fhe server via 
AppleTalk or fhe Transmission Confrol Profocol/Infernef Profocol (TCP/IP). 
Figure 9-1 shows fhe .AFPTranslafor driver and ifs position in fhe flow of dafa 
befween FITS and AFP commands and fhe dafa sfream inferface (for TCP/IP) 
and fhe .XPP driver (for AppleTalk). 
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Figure 1-1 The .AFPTranslator driver 


HFS commands 


AFP commands 


.AFPTranslator driver 


Data stream interface (TCP/IP) 


.XPP driver (AppleTalk) 


For information on the data stream interface (DSI), see the AppleTalk Filing 
Protocol Version 2.1 and 1.1 in the AppleShare IP 6.3 Developer's Kit. 

Note 

Prior to AppleShare Client 3.7, the .XPP driver was 
responsible for sending AFP commands from the client to 
the server. With AppleShare Client 3.7, the .AFPTranslator 
driver is responsible for sending AFP commands to the 
server. The .AFPTranslator driver and the .XPP driver do 
not use the same session reference number, so if AFP 
commands are sent to the .XPP driver when the 
AppleShare Client 3.7 is installed and the session is 
rurming over TCP/IP, errors will occur. If the session is 
rurming over AppleTalk and afpSVolInfois used to get the 
session reference number, the session may be lost. ♦ 

The programming interface to the .AFPTranslator driver on the workstation 
consists of three functions: 

■ NAFPConitiiandSync, for sending commands to an AFP server synchronously 

■ NAFPConitiiandAsync, for sending commands to an AFP server asynchronously 

■ NAFPConiniandlnitnedi ate, for sending a command to an AFP server without 
going through the Device Manager queue, such as a command to close all 
open sessions with all connected AFP servers 
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The three functions pass to the .AFPTranslator driver the command code and 
parameters for an AFP command. 

Note 

Because fhe native file sysfem commands implemenf mosf 
of fhe funcfions fhaf you need fo access an AFP server, in 
mosf cases you will nof need fo use AFP direcfly For fhis 
reason, fhis chapfer does nof include a "Using" section, as 
do mosf of fhe ofher chapfers in fhis book. If fhe native file 
sysfem implemenfs a funcfion you need, you should use 
fhe file sysfem command. If you wanf fo implemenf a 
funcfion fhaf is nof parf of fhe native file sysfem, you can 
use AFP direcfly. In fhis case, you should continue fo read 
fhis chapfer. ♦ 


AFP Reference 


This section describes fhe dafa sfrucfures and funcfions fhaf are specific fo fhe 
AppleTalk Filing Profocol (AFP). 

The "Dafa Sfrucfures" secfion describes fhe consfanfs and dafa sfrucfures used 
by fhe AFP funcfions. 

The "Roufines" secfion describes fhe AFP programming inferface, which 
consisfs of fhree funcfions (NAFPCommandAsync, NAFPCommandSync, and 
NAFPCommandImmedi ate), which allow you fo communicafe wifh an AFP server 
and specify from wifhin a DSParamPB sfrucfure a parficular command and ifs 
paramefers fo send across fhe session fo fhe server. 


Data Structures 


This secfion describes fhe dafa sfrucfures fhaf you use fo provide information fo 
fhe AppleTalk Filing Profocol (AFP). 


DSParamBlock Structure 

You pass a DSParamBlock sfrucfure as a paramefer fo fhe fhree AFP funcfions: 

AFPNAFPCommandSync, NAFPCommandAsync, and NAFPCommandImmedi ate. 
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The first four fields of the DSParaniBl ock structure, qLi nk, qType, i oTrap, and 
i oCnidAddr, are used internally by the Device Manager. 

You must specify the .AFPTranslator driver reference number as the input value 
of the i oCRef Num field. You can use the Device Manager's OpenDri ver function to 
obtain the .AFPTranslator driver reference number. 

struct DSParatriBl ock { 


QEletn * 

qEi nk; 

short 

qType; 

short 

ioTrap; 

Ptr 

ioCmdAddr; 

DSIOCompletionUPP 

ioCompletion; 

OSErr 

ioResult; 

1 ong 

cmdResult; 

short 

ioVRefNum; 

short 

ioCRefNum; 

short 

csCode; 

short 

dsTimeout; 

short 

dsReservedl; 

1 ong 

dsRetry; 

uintie 

dsReservedk; 

short 

dsSessRefNum; 

short 

dsReservedS; 

short 

dsCmdBufferSize; 

uinte * 

dsCmdBuffer; 

UInt32 

dsReplyBufferSize; 

Uinte * 

dsReplyBuffer; 

union { 

) csParatn; 

DSOpenPB open; 
DSWritePB write; 

DSGetStatusPB status 


): 

typedef struct DSParatnBl ock DSParatnBl ock; 


Field descriptions 


qEi nk 

Reserved. 

qType 

Reserved. 

ioTrap 

Reserved. 

ioCmdAddr 

Reserved. 
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i oCompl eti on A pointer to a completion routine (page 1-34) if the 

structure is being passed as a parameter to 

NAFPCommandAsync. 

i 0 Resu 11 Contains the result when the DSParamPB structure is passed 

as an parameter to NAFPCommandAsync. 

cmdResul t Four bytes of dafa refumed from fhe server indicating fhe 

resulf of an AFP command. 

ioVRefNum Reserved. 

ioCRefNum Reference number from fhe .AFPTranslafor driver. 

csCode The PB confrol or PB sfafus code (page 1-17) for fhis 

operafion. 

dsTi meout For sessions over AppleTalk, fhe inferval in seconds fhaf 

fhe .AFPTranslafor driver waifs between refries of fhe AFP 
command. For sessions over TCP/IP, dsTi meout is reserved. 

dsReserved Reserved. 

dsRetry For sessions over AppleTalk, fhe number of fimes fo resend 

fhe requesf. For sessions over TCP/IP, dsRetry is reserved. 

dsReservedC Reserved. 

dsSessRefNum The session reference number, which is a unique number 

fhaf fhe .AFPTranslafor driver assigns fo fhe session and 
ref urns in response foanafpLogin command. 

dsReservedS Reserved. 

dsCmdBuf f erSi ze The size inbyfes of dsCmdBuf f er. The size of fhe dsCmdBuf fer 
musf nof exceed fhe value of aspMaxCmdSi ze (576 byfes) fhaf 
fhe ASPGetParms function refurns. 

dsCmdBuffer Apoinfer fo fhe command buffer, which confains 

command paramefers associafed wifh fhe command code 
stored in csCode. When fhe value of cscode is 
dsOpenSession, dsCmdBuffer musf be kFPLogi n. When fhe 
value of cscode is dsCl oseSessi on, fhe value of dsCmdBuffer 
musf be kFPLogout. 

dsReplyBufferSi ze On inpuf, fhe size inbyfes of dsReplyBuffer, which is fo 
hold fhe expected response fo fhe AFP command. On 
ref um, dsReplyBufferSi ze conf ains fhe acfual size of fhe 
reply pointed fo by dsRepl yBuffer. 

dsReplyBuffer A poinf er fo fhe reply buffer. 
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csparatn A union whose value can be a PBOpenPB, DBWri tePB, or 

DBGetStatus structure for opening a session, writing, and 
getting the server's status, respectively. 


PB Control and PB Status Codes 

You provide a PB control code or a PB status code in the csCode field of fhe 
DSParaniPB sfrucfure (page 1-22) fo specify fhe type of operafion for which fhe 
sfrucfure will be used when if is passed as a paramefer fo NAFPCommandAsync, 
NAFPConittiandSync, or NAFPCommandImmedi ate. Table 1-1 lisfs fhe PB confrol codes. 

Table 1-1 PB control codes 


Constant 

Code 

Meaning 

dsIOCTL 

231 

Makes an lOCTL call to the session encpoint if 
the transport protocol for the session is 

TCP/IP. 

dsCloseAl1 

232 

Closes all open sessions. 

dsCl oseSession 

237 

Closes the specified session. 

dsSendRequest 

240 

Sends an AFP command to the server. For the 
list of AFP commands, see Table 1-3. 

dsGetStatus 

243 

Sends aGetSrvrInfo request to the server. The 
value of DSParamPB.es Pa ram must be a 
DSGetStatusPB structure. 

dsOpenSession 

244 

Opens an AFP session with the specified 
server. The value of DSParatnPB. esParatn must be 
a DSOpenPB structure. 

AFPReniSessMetiiBl k 

245 

Removes the session memory block from the 
.AFPTranslator driver's queue. 

AFPInsSessMeniBl k 

246 

Inserts the session memory block into the 
.AFPTranslator driver's queue. 

afpGetAttnRoutine 

252 

Returns a pointer to the default AFP attention 
routine. 


Table 1-2 lists the PB status codes. 
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Table 1-2 PB status codes 


Constant 

Code 

Meaning 

atpGetSMBSize 

118 

Gets the size of the session memory 
block. 

afpXGetVolInfo 

121 

Gets extended information about the 
specified volume, such as server time 
offset and volume grade. 

afpSVolInfo 

124 

Returns information in a 

GetVol SessInfoRec structure about the 
specified server, such as its name and 
OT address, and the name the user 
used to connect. 

afpGetFSID 

127 

Gets the file system ID. 

dsGetXportInfo 

236 

Gets information about the session's 
transport protocol. 


AFPInsRemSMBParam Structure 

You pass an AFPInsRemSMBParam structure as a parameter when you send a PB 
control code ofAFPInsSessMemBlkto insert the session memory block into the 
■AFPTranslator driver's queue or a PB control code of AFPRemSessMemBl k to 
remove the session memory block from the .AFPTranslator driver's queue. 

Note 

You must insert the session memory block after you 
successfully open a session with a server. After you close a 
session with a server, you should remove the session 
memory block. 

struct AFPInsRemSMBParam { 


QEl emPtr 

qLi nk; 

short 

qfype; 

short 

ioTrap; 

Ptr 

ioCmdAddr; 

lOCompl eti onllPP 

ioCompletion; 

OSErr 

ioResult; 

StringPtr 

ioNamePtr; 

short 

ioVRefNum; 
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short 

i oRef Nutn; 

short 

csCode; 

Ptr 

): 

stnbPtr: 

Field descriptions 

qti nk 

Reserved. 

qfype 

Reserved. 

ioTrap 

Reserved. 

i oCnidAddr 

Reserved. 

i oCotiipl eti on 

On input, a pointer to an completion routine (page 1-34). 

i oResult 

On output, if the AFPInsRemSMBParam structure is passed as a 
parameter to NAFPConiniandAsync, contains the result code. 

i oNaniePtr 

Reserved. 

i oVRef Nuni 

Reserved. 

i oRef Nutti 

On input, the driver reference number provided by the 
.AFPTranslator driver. 

csCode 

On input, AFPInsSessMemBlkto insert the session memory 
block or AFPRemSessMemBl k to remove the session memory 
block. 

snibPtr 

On input and output, a pointer to the session memory 


block that is to be inserted or removed. 


AFPSrvrInfo Structure 

You receive a AFPSrvrInfo structure containing information about the server 
when you send a PB status code ofdsGetStatusto the server. 

Note 

This section describes only the fixed porfion of fhe 
AFPSrvrInfo sfrucfure. The variable-lengfhporfion of fhis 
sfrucfure is described in fhe AppleTalk Filing Protocol Version 
2.1 and 2.2 documenf in fhe AppleShare IP 6.3 Developer's 
Kit. ♦ 

struct AFPSrvrInfo { 

short fMachineOffset: 

short fVerCountOffset: 
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short fUAMCountOffset; 

short fIconOffset; 

short fFlags; 

unsigned char fSrvrName[2]; 

1 ; 

typedef struct AFPSrvrInfo AFPSrvrInfo; 

Field descriptions 

fMachi neOffset Offset to the server's machine t 5 rpe. 

fVerCountOffset Offset to the number of versions of AFP that the server 

supports. 

f UAMCountOf f set Offset to the number of UAMs that the server supports. 

fIconOffset Offset to the server's icon. 

fFlags Values that describe the server's capabilities. For details, 

see the enumeration later in this section. 
fSrvrName Offset to the server's name. 

The following enumeration describes server capabilities returned in the fFlags 
field. 

enum { 

srvSCopyFile = 0, /* Server supports FPCopyFile call */ 

srvSChangePswd = 1, /* Server supports FPChangePassword call */ 
srvNoPswdSave = 2, /* Workstation should not save password */ 

srvSServerMsgs = 3, /* Server supports server messages */ 

srvSSrvrSig = 4, /* Server supports server signatures (AFP 2.2)*/ 

srvSupportsTCP = 5, /* Server supports TCP/IP (AFP 2.2) * 

srvSNotification= 6 /* Server will send notifications (AFP 2.2) */ 

1 ; 


DSGetStatusPB Structure 

You use a DSGetStatusPB structure when you send PB control code of 
dsGetStatus command code to the server. The DSGetStatusPB structure identifies 
the address of the server that is to return status information in an AFPSrvrInfo 
structure (page 1-19). 
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struct DSGetStatusPB { 

OTAddress * dsGSSrvrAddress: 

const char * dsGSEpString; 

): 

typedef struct DSGetStatusPB DSGetStatusPB: 

Field descriptions 

dsGSSrvrAddress The OT address of the server, which is either an 

OTDDPAddress (for AppleTalk) or an InetAddress (for TCP/ 
IP). 

dsGSEpString The endpoint string for the connection. The default is n i 1 . 

The endpoint string provides a way to specify streams 
configuration information on a per-cormection basis. It is 
only used for TCP/IP connections and is ignored for 
AppleTalk cormections. 

You also need to fill in the dsReplyBuffer and dsReplyBufferSize fields in the 
DSParatiiPB structure. 

Note 

You should make the dsReplyBuffer field of the 
DSParatiiBl ock structure at least 1024bytes in size. ♦ 

DSOpenPB Structure 

You use a DSOpenPB structure when you send a PB control code ofdsOpenSession 
to the server. 

struct DSOpenPB { 

AttnRoutineUPP dsOSAttnRouti ne : 

OTAddress * dsOSSrvrAddress: 

Ptr dsOSSessionBl ock: 

const char *dsOSEpString: 

): 

typedef struct DSOpenPB DSOpenPB: 

Field descriptions 

dsOSAttnRouti ne A custom attention routine. To use the default attention 
routine, set dsOSAttnRouti ne to ni 1. 
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dsOSSrvrAddress The OT address of the server, which is either an 

OTDDPAddress (for AppleTalk) or an InetAddress (for TCP/ 
IP), with which a session is to be opened. 
dsOSSessionBlock A pointer to the block of memory reserved for this session. 

At minimum, the size of the block must be SMBs i ze. 
dsOSEpString The endpoint string for the connection. To use the default 

endpoint string, set dsOSEpString to nil. The endpoint 
string provides a way to specify streams configuration 
information on a per-connection basis. It is only used for 
TCP/IP connections and is ignored for AppleTalk 
connections. 


DSWritePB Structure 

You use a DSWritePB structure when you send the AFP command afpWriteto the 
server. 

struct DSWritePB { 

UInt32 dsWriteDataOffset; 

UInt32 dsWriteBufferSize; 

Byte * dsWriteBuffer; 

1 ; 

typedef struct DSWritePB DSWritePB; 

Field descriptions 

DSWriteDataOffset The offset at which the data is to be written. 
dsWri teBufferSize The size of the data that is to be written. 
dsWri teBuffer A pointer to the data that is to be written. 


DSXPortInfo Structure 

You use a DSXPortInfo structure when you call NAFPCommandAsync or 
NAFPCommandSync with a DSParamPB structure (page 1-22) whose csCode field is 
dsGetXPortInfo. The dsGetXPortInfo structure contains extended port 
information. 

struct DSXPortInfo { 

long dsXPortfype; /* Transport Type (kASPXport, kTCPXport) */ 

short dsXPortSessRefNum;/* Session reference number for ASP or TCP */ 
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union { 

InetAddress ipAddr; 

DDPAddress ddpAddr; 

) addr; 

): 

typedef struct DSXPortInfo DSXPortlnfo; 

Field descriptions 

dsXPortType On return, the transport type of the specified session 

(kASPXport for AppleTalk or kTCPXport for TCP/IP). 

dsXPortSessRefNuni On inpuf, fhe session reference number of fhe session for 
which you wanf fo defermine fhe fransporf fype. 
addr On inpuf, fhe IP address (for TCP/IP sessions) or fhe 

AppleTalk address (for AppleTalk sessions) of fhe server 
for which you wanf fo defermine fhe fransporf fype. 

GetVolSessInfoPB Structure 

You use a GetVolSessInfoPB structure when you call NAFPConiniandAsync or 
NAFPConiniandSync with a DSParamPB structure (page 1-22) whose csCode field is 
dsGetSVol Info. 

The server returns in the GetVolSessionInfoPB structure information about the 
volume for which there is an open session, such as the AFP version number, 
session reference number, volume ID, server address, UAM t 5 cpe, and pointers 
to the user name string, volume icon, and Get Info "where" string in a 
GetVol SessInfoRec structure (page 1-24). 

struct GetVolSessInfoPB { 

QEl emPtr 
short 
short 
Ptr 

lOCotnpl eti onUPP 
OSErr 
StringPtr 
short 
short 
short 
Ptr 


qLi nk; 
qfype; 
ioTrap; 
ioCmdAddr; 
ioCompletion ; 
ioResult; 
ioNamePtr; 
ioVRefNum; 
ioRefNum; 
csCode; 
vcbPtr; 
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GetVolSessInfoRecPtr sessInfoBuffer; 

1 ong 

sessInfoSize ; 

1 ong 

1 ; 

actSessInfoSize; 

Field descriptions 

qLi nk 

Reserved. 

qfype 

Reserved. 

iof rap 

Reserved. 

ioCmdAddr 

Reserved. 

ioCompletion 

A pointer to an I/O completion routine (page 1-34). 

ioResult 

On output, the result when the DSParamPB structure is 
passed as an parameter to NAFPCommandAsync. 

ioNamePtr 

Reserved. 

ioVRefNum 

Reserved. 

ioRefNum 

The driver reference number provided by the 
.AFPTranslator driver. 

csCode 

Always the afpSVol Info command. 

vcbPtr 

On input, a pointer to the volume control block (VCB) for 
the volume for which you are getting volume information. 

sessInfoBuffer 

On input, a pointer to the GetVolSessInfoRec structure in 
which information about the volume is to be placed. 

sessInfoSize 

On input, the size in bytes of sessInfoBuffer. 

actSessInfoSize 

GetVolSessInfoRec Structure 

On output, the size in bytes of the data returned in 

sessInfoBuffer. 


You receive a GetVolSessInfoRec structure when you call NAFPCommandAsync or 
NAFPCommandSync with a DSPa ramPB structure whose csCode member is 
afpSVolInfo. The GetVolSessInfoRec structure contains basic information, such 
as the server's name and address and the name of fhe user who connecfed fo 
fhe volume. 

struct GetVolSessInfoRec { 

short sessAFPVersion; 

short sessReferenceNumber; 
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short 

sessAFPVolID; 

OTAddress 

* sessServerAddress: 

short 

sessUAMType; 

StringPtr 

sessUserNamePtr; 

Ptr 

sessVolIconPtr; 

StringPtr 

sessWhereStringPtr 


typedef struct GetVol SessInfoRec GetVolSessInfoRec; 


Field descriptions 

sessAFPVersion On output, the version of AFP being used for fhe session as 
defined by fhe following enumerafion: 

enutn { 

kAFPVersionll = 1, 
kAFPVersion20 = 2, 
kAFPVersion21 = 3, 
kAFPVersion22 = 4 


sessReferenceNumber 

On oufpuf, fhe AFP session reference number for fhis 
session. 

sessAFPVol ID On oufpuf, fhe volume's AFP volume idenfifier. 

sessServerAddress On oufpuf, fhe server's address .For AppleTalk sessions, 
sessServerAddress is an AppleTalk address; for TCP/IP 
sessions, sessServerAddress is an IP address. 

sessUAMType On oufpuf, a consfanf fhaf describes fhe user aufhenficafion 

mefhod (page 1-25) fhaf was used fo aufhenficafe fhe 
session. 


sessUserNamePtr Apoinfer fo fhe user name sfring. 

sessVolIconPtr A poinfer fo fhe server volume icon mask for fhis volume. 

sessWhereStringPtr A poinfer f o fhe "where" information sfring, which fhe 
Finder displays in fhe Gef Info window for fhis volume. 


User Authentication Constants 

Information about the user authentication method (UAM) that was used to 
authenticate a session is returned in the U A M Ty p e field of the GetVolSessInfoRec 
structure (page 1-24). 
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enum { 


kNoUserAuth 

= 1, 

/* 

No User Authentication UAM 

(Guest) 

*/ 

kClea rtextAuth 

= 2, 

/* 

Cleartext Password UAM */ 



kRandnumAuth 

= 3, 

/* 

Random Number Exchange UAM 

*/ 


k2WayRandnumAuth 

= 6, 

/* 

Two-Way Random Number Exchange UAM 

*/ 

kEncryptPassXport 

= 7, 

/* 

DHXCAST128 UAM */ 



kMinCustomUAM 

= 128 

/* 

Minimum value for a custom 

UAM */ 



1 ; 

Note 

Authentications that begin with kCl ea rtextAuth or 
kRandnumAuth are automatically convered to 
k2WayRandnumAuth if k2WayRandnumAuth is available. ♦ 


AFP Gestalt Constants 


The following AFP gesfalf consfanfs can be used fo defermine fhe capabilifies of 
an AFP clienf. 


gesta 

tAFPCl 

i ent 

= 

FOUR 

gesta 

tAFPCl 

ientVersionMask 

= 

0x00 

gesta 

tAFPCl 

ient3_5 

= 

1, 

gesta 

tAFPCl 

ient3_6 

= 

2, 

gesta 

tAFPCl 

ient3_6_l 

= 

3, 

gesta 

tAFPCl 

ient3_6_2 

= 

4, 

gesta 

tAFPCl 

ient3_6_3 

= 

5, 

gesta 

tAFPCl 

ient3_7 

= 

6, 

gesta 

tAFPCl 

ient3_7_2 

= 

7, 

gesta 

tAFPCl 

ient3_8 

= 

8, 

gesta 

tAFPCl 

ientCfgMas k 

= 

(1 on 

gesta 

tAFPCl 

ientCfgRs rc 

= 

16, 

gesta 

tAFPCl 

ientUAMv2 

= 

28, 

gesta 

tAFPCl 

ientSupports IP 

= 

29, 

gesta 

tAFPCl 

ientVMUI 

= 

30, 


version */ 


/* Includes 3.6.4, 
/* Includes 3.7.1 
/* Includes 3.7.3 


config */ 


3.6.5 */ 


/* Client supports the 2.0 UAM 
interfaces */ 

/* Client supports AFP over 
TCP/IP */ 

/* Client can put up UI from th 
PBVolMount trap */ 
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gestaltAFPClientMultiReq 

): 


= 31 /* Client supports multiple 

outstanding requests */ 


Routines 


The programming interface to AFP is different in form from the programming 
interfaces to the other AppleTalk protocols described in this book. For AFP, the 
programming interface consists of three functions: 

■ NAFPConiniandAsync, which allows you to call AFP asynchronously and pass it 
the command code for a particular AFP command. 

■ NAFPConiniandSync, which allows you to call AFP synchronously and pass it the 
command code for a particular AFP command. 

■ NAFPCotntnandlniniedi ate, which you use to bypass the Device Manager and 
send an AFP command directly to the server so that the server can act on the 
command immediately. 

All three functions require as a parameter a pointer to a data stream (DS) 
parameter block. The DS parameter block's csCode field contains a value that 
identifies the purpose for which the parameter block is intended. To send an 
AFP command, you specify a pointer to a command buffer, the first byte of 
which contains the AFP command, followed by any information required for 
the specified AFP command. 

Before you send an AFP command code, you must use the Device Manager's 
OpenDriver function to open the .AFPTranslator driver. 

In most circumstances, you should not close the .AFPTranslator driver because 
other applications and processes could be using the protocols implemented by 
the .AFPTranslator driver. 
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Table 1-3 lists the AFP command 


Table 1-3 AFP command codes 


AFP Command 

command constant code 

kFPByteRangeLock 1 

kFPCloseVol 2 

kFPCloseDir 3 

kFPCloseFork 4 

kFPCopyFile 5 

kFPCreateDir 6 

kFPCreateFi1e 7 

kFPDelete 8 

kFPEnumerate 9 

kFPFlush 10 

kFPFlushFork 11 

kFPGetForkParms 14 
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Action 


Locks or unlocks a specified range of 
byfes wifhin an open fork. 

Informs fhe server fhaf fhe worksfafion 
no longer needs fhe volume. 

Closes a directory and invalidafes ifs 
direcfory idenfifier. 

Closes a fork fhaf was opened by 

kFPOpenFork. 

Copies a file from one locafion fo 
anofher on fhe same file server. 

Creates a new direcfory. 

Creates a new file. 

Deletes a file or direcfory. 

Lisfs fhe confenfs of a direcfory. 

Writes fo a disk any volume dafa fhaf 
has been modified. 

Writes fo a disk any dafa buffered from 
previous kFPWrite calls. 

Refrieves paramefers for a file 
associafed wifh a parficular open fork. 
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Table 1-3 AFP command codes (continued) 


AFP Command 

command constant code 

kFPGetSrvrInfo 15 


kFPGetSrvrParnis 16 

kFPGetVol Parnis 17 

kFPLogin 18 

kFPLoginCont 19 

kFPLogout 20 

kFPMapID 21 

kFPMapNanie 22 

kFPMoveAndRenanie 23 

kFPOpenVol 24 

kFPOpenDir 25 

kFPOpenFork 26 

kFPRead 27 


Action 

Obtains a block of descriptive 
information from the server, without 
requiring an open session. 

Use the ASPGetStatus function instead of 
this command code. See the chapter 
"AppleTalk Session Protocol (ASP)" in 
this book for information on 
ASPGetStatus. Making an kFPGetSInfo 
call using the AFPConiniand results in an 
error. 

Retrieves server parameters. 

Retrieves parameters for a particular 
volume. 

Establishes an AFP session with a server. 

Continues the login and user 
authentication process started by the 
kFPLogin command. 

Terminates a session with a server. 

Maps a user ID to a user name, or a 
group ID to a group name. 

Maps a user name to a user ID, or a 
group name to a group ID. 

Moves a directory or file to another 
location on the same volume. 

Makes a volume available to the 
workstation. 

Opens a directory on a variable 
directory ID volume and returns its 
directory ID. 

Opens the data or resource fork of an 
existing file to read from it or write to it. 

Reads a block of data from an open fork. 
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Table 1-3 AFP command codes (continued) 


AFP 

command constant 

Command 

code 

Action 

kFPRename 

28 

Renames a directory or file. 

kFPSetDirPa rms 

29 

Sets parameters for a specified directory. 

kFPSetFi1ePa rms 

30 

Sets parameters for a specified file. 

kFPSetForkPa rms 

31 

Sets the fork length for a specified open 
fork. 

kFPSetVolPa rms 

32 

Sets the backup date for a specified 
volume. 

kFPWrite 

33 

Writes a block of data to an open fork. 

kFPGetFlDrPa rms 

34 

Retrieves parameters for either a file or a 
directory. 

kFPChangePassword 

36 

Changes a user's password. 

kFPSetFiDrPa rms 

35 

Sets parameters for a file or directory. 

kFPGetUserInfo 

37 

Gets user information. 

kFPGetSrvrMsg 

38 

Gets a string message from the server, 
such as shutdown, user, and login 



messages. 

kFPCreatelD 

39 

Creates a unique file ID for a specified 
file. 

kFPDeletelD 

40 

Invalidates all instances of a specified 
file ID. 

kFPResolveto 

41 

Returns parameters for the file referred 
to by the specified file ID. 

kFPExchangeFi1es 

42 

Preserves an existing file ID when an 
application performs a "Save" or "Save 
As" operation. 

kFPCatSea rch 

43 

Allows an application to efficiently 
search an entire volume for files that 
match specified criteria. 


continued 
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Table 1-3 AFP command codes (continued) 


AFP 

Command 


command constant 

code 

Action 

kFPOpenDT 

48 

Opens the Desktop database on a 
particular volume. 

kFPCloseDT 

49 

Informs the server that the workstation 
no longer needs the volume's Desktop 
database. 

kFPGetIcon 

51 

Retrieves an icon from the volume's 
Desktop database. 

kFPGtIconInfo 

52 

Retrieves icon information from the 
volume's Desktop database. 

kFPAddAPPL 

53 

Adds an APPL mapping to the Desktop 
database. 

kFPRetnoveAPPL 

54 

Removes an APPL mapping from the 
volume's Desktop database. 

kFPGetAPPL 

55 

Retrieves an APPL mapping from the 
volume's Desktop database. 

kFPAddConinient 

56 

Adds a comment for a file or directory 
to the volume's Desktop database. 

kFPRenioveConinient 

57 

Removes a comment from the volume's 
Desktop database. 

kFPGetConinient 

58 

Retrieves a comment associated with a 
specified file or directory from the 
volume's Desktop database. 

kFPAddIcon 

192 

Adds an icon bitmap to the volume's 
Desktop database. 


For a description of the commands and their required command block formats 
and parameters, see the following documents: 

■ For command codes 38 through 43, inclusive, see the AppleTalk Filing Protocol 
Version 2.1 and 2.2 document in the AppleShare IP 6.3 Developer's Kit. 

m For all other AFP command codes, see Inside AppleTalk, second edition. 
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NAFPCommandAsync Function 

Communicate asynchronously with an AFP server. 

OSErr NAFPCommandAsync (DSParamBlockPtr paramblock); 
paramBl ock Apointer to a DSParamBl ock structure (page 1-22). 


DESCRIPTION 

You use the NAFPCommandAsync function to communicate asynchronously with an 
AFP server. 

To prepare paramblock for sending to a server, set the csCode field to an 
appropriate PB control (page 1-17) or PB status code (page 1-18) and set the 
dsCmdBuffer field so that it contains the data structure that is appropriate for the 
value of csCode. 

To send an AFP command to the server, set the csCode field to dsSend Re quest, 
and prepare the dsCmdBuffer field so that it contains the appropriate AFP 
command code (listed in Table 1-3 (page 28)), followed by the command block 
for the specified code. For information on command block formats for 
command codes 38 through 43, inclusive, see the AppleTalk Filing Protocol 
Version 2.1 and 2.2 in the AppleShare IP 6.3 Developer's Kit. For information on 
command block formats for all other AFP command codes, see Inside AppleTalk, 
second edition. 


RESULT CODES 

The NAFPCommandSync function can return any of the result codes listed in "Result 
Codes" (page 53). 

NAFPCommandSync Function 

Communicate S 5 mchronously with an AFP server 

OSErr NAFPCommandSync (DSParamBlockPtr paramBlock); 
paramBl ock Apointer to a DSParamBl ock structure (page 1-22). 
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DESCRIPTION 

The NAFPCommandSync function provides a way to send an AFP command to the 
server and receive a reply synchronously 

To prepare pa rambl ock for sending to a server, set the csCode field to an 
appropriate PB control (page 1-17) or PB status code (page 1-18) and set the 
dsCnidBuffer field so that it contains the data structure that is appropriate for the 
value of csCode. 

To prepare pa rambl ock for sending an AFP command, set the csCode field to 
dsSendRequest, and prepare the dsCmdBuffer field so that it contains the 
appropriate AFP command code (listed in Table 1-3 (page 28)), followed by the 
command block for the specified code. For information on command block 
formats for command codes 38 through 43, inclusive, see the AppleTalk Filing 
Protocol Version 2.1 and 2.2 in the AppleShare IP 6.3 Developer's Kit. For 
information on command block formats for all other AFP command codes, see 
Inside AppleTalk, second edition. 


RESULT CODES 

The NAFPCommandSync function can return any of the result codes listed in "Result 
Codes" (page 53). 

NAFPCommandImmediate Function 

Communicate directly with an AFP server. 

OSErr NAFPCommandImmediate (DSParamBlockPtr paramBlock); 
parambl ock Apointer to a DSParamBl ock structure (page 1-22). 


DESCRIPTION 

You use the NAFPCommandImmedi ate function to b 5 rpass the Device Manager and 
send commands directly to a server for immediate response. You typically use 
the NAFPCommandImmedi ate function to send a command that requires immediate 
attention, such asdsCloseAll to close all open sessions immediately. 
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RESULT CODES 

The NAFPCommandImmedi ate function can return any of the result codes listed in 
"Result Codes" (page 53). 

Completion Routine 

The DSParamPB, GetVol SessInfoPB, and AFPInsRemSMBParam structures each 
include a pointer to an I/O completion routine that uses register-based 
parameters under classic 68k and cannot be written in a high-level language 
without the help of mixed mode or assembly glue. 


Summary of AFP 


Pascal Summary 


Constants 

CONST 

afpGetAttnRoutine = 252; 

dsOpenSession = 244; 

dsGetStatus = 243; 

dsSendRequest = 240; 

dsCloseSession = 237; 

dsCloseAl1 = 232; 

AFPInsSessMemBlk = 246; 

AFPRemSessMemBlk = 245 

afpGetFSID = 127, 

afpSVolInfo = 124, 

afpXGetVolInfo = 121, 

dsGetXPortInfo = 236 

SMBSize = 2560; {size of session block memory) 


{ PBControl calls ) 


( PBStatus calls ) 
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Data Types 


Send Request Parameter Block 

{ csCode = dsSendRequest ) 

DSWritePBPtr = ''DSWritePB; 

DSWritePB = RECORD 

dsWriteData0ffset:UInt32; { Specifies the write offset in the data ) 
dsWriteBufferSize:UInt32; { Size of the data to be written ) 
dsWriteBuffer:Ptr : { Pointer to data to be written ) 

END: 


Get Status Parameter Block 

{ csCode = dsGetStatus ) 

DSGetStatusPBPtr = ''DSGetStatusPB; 

DSGetStatusPB = RECORD 

dsGSSrvrAddress:OTAddressPtr; { OT Address of server to GetStatusi) from ) 

{ (you also need to fill in the reply buffer ) 
{ and size) ) 

dsGSEpString:ConstCStringPtr; { Endpoint string for the connection (nil } 

{ == default) 1 

END: 


Open Session Parameter Block 


csCode = dsOpenSession ) 

DSOpenPBPtr = ''DSOpenPB: 

DSOpenPB = RECORD 

dsOSAttnRoutine:AttnRoutineUPP: 
dsOSSrvrAddress:OTAddressPtr: 
dsOSSessionBlock:Ptr: 


{ Custom attention routine: nil == default) ) 
{ OT Address of server to open a session with 
( Pointer to the SMB reserved for the 1 
{ session ) 


dsOSEpString:ConstCStringPtr: 


END: 


) Endpoint string for the connection: 
{ (nil == default) ) 
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DSParamBlock Record 

TYPE 

DSPa ramBl ockPtr = ''DSParamBlock; 

DSParamBlock = RECORD 

qLink; QElemPtr; {Reserved! 

qType; INTEGER; { Reserved 1 

ioTrap; INTEGER; { Reserved 1 

ioCmdAddr; Ptr; {Reserved 1 

ioCompletion; DSIOCompletionUPP; { Completion routine 1 


ioResult; 

OSErr; 

cmdResult; 

LONGINT 

ioVRefNum; 

INTEGER 

ioCRefNum; 

INTEGER 

csCode; 

INTEGER 

dsTimeout; 

INTEGER 

dsReservedl; 

INTEGER 

dsRetry; 

LONGINT 

dsReservedC; 

UIntl6; 

dsSessRefNum; 

INTEGER 

dsReservedB; 

INTEGER 

dsCmdBufferSize; 

INTEGER 

dsCmdBuffer; 

Ptr; 

dsReplyBufferSize; 
dsReplyBuffer;Ptr; 
CASE INTEGER OF 

0; ( 

UInt32; 


open; DSOpenPB; 

); 

1 ; ( 

write; DSWritePB; 

); 

2 ; ( 

status; DSGetStatusPB; 

); 

END; 

{ definitions for dsXPortType 1 
CONST 

kASPXport = $00; 

kTCPXport = $01; 


{ Result code 1 
{ Command result 1 
{ Reserved 1 

{ .AFPTranslator driver reference number 1 
{ DS Command code 1 
{ Timeout (AppleTalk only) 1 
{ Reserved 1 

{ Retry (AppleTalk only) 1 
{ Reserved 1 
{ AFP session number 1 
{ Reserved 1 

{ Size of t[ie command buffer 1 
{ Pointer to tlie command buffer 1 
{ Size of t[ie reply buffer 1 
{ Pointer to tlie reply buffer 1 
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GetVolSessInfoRec Record 


TYPE 


GetVol Sess Inf oRecPtr = ''GetVolSessInfoRec; 
GetVolSessInfoRec = RECORD 


sessAEPVersion: 
sessReferenceNumber: 
sessAEPVolID: 
sessServerAddress: 
sessUAMType: 
sessUserNamePtr: 
sessVolIconPtr: 
sessWhereStringPtr: 


INTEGER: 
INTEGER: 
INTEGER: 
OTAddressPtr: 
INTEGER: 

StringPtr: 

Ptr: 

StringPtr: 


END: 


AEP version number ( 

AEP session reference number ( 

AEP volume identifier ( 

Server internet address ) 

User authentication method ( 

Pointer to user name string ( 

Pointer to server volume icon/mask ( 
Pointer to ''where'' information 
string shown in the Get Info window ) 


CONST 

kAEPVersionll = 1: 

kAEPVersion20 = 2; 

kAEPVersion21 = 3: 

kAEPVersion22 = 4: 

kNoUserAuth = 1: 

kCleartextAuth = 2; 

kRandnumAuth = 3: 

k2WayRandnumAuth= 6: 
kMinCustomUAM = 128: 


( 'No User Authent' UAM (Guest) ( 

( 'Cleartxt Passwrd' UAM (types 2 & 3 will be 
{ automatically upgraded to 6) 1 
( 'Randnum Exchange' UAM ( 

( '2-Way Randnum exchange' ( 

( Minimum type value for a custom UAM ( 


GetVolSessInfoPB Record 


TYPE 


GetVol SessInfoPBPtr = ''GetVolSessInfoPB; 
GetVolSessInfoPB = RECORD 


qEi nk: 
qType: 
ioTrap: 
ioCmdAddr: 
ioCompletion: 
ioResult: 


OEl emPtr; 
INTEGER; 

INTEGER; 

Ptr; 

lOCompletionUPP: 
OSErr; 


{ Standard header information 
( Standard header information 
{ Standard header information 
( Standard header information 
{ Completion routine pointer ) 
( Result from async call ( 
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ioNamePtr; 
ioVRefNum: 
ioRefNum: 
csCode; 
vcbPtr; 


StringPtr; { 
INTEGER; { 
INTEGER; { 
INTEGER; { 
Ptr; { 


sessInfoBuffer; GetVolSessInfoRecPtr; 


sessInfoSize;LONGINT; { 

actSessInfoSize;LONGINT; { 

END; 


Standard header information 1 
Standard header information 1 
RefNum of the ".AFPTranslator" 1 
Always afpSVolInfo 1 
Pointer to the VCB that you want 
information about ) 

{ Pointer to the GetVolSessInfoRec to 
be filled ) 

Size of the GetVolSessInfoRec 1 
Actual size of the data returned 1 


AFPInsRemSMBParam Record 

{ The AFPInsSessMemBlk and AFPRemSessMemBlk calls are currently 

required when opening or closing a session. Make the AFPInsSessMemBlk call after the 
dsOpenSession call succeeds (or returns afpAuthContinue), with the same 
dsOSSessionBlock that you sent into dsOpenSession. You need to call 
AFPRemSessMemBlk with that same pointer after calling dsCloseSession or dsCloseAll. 

1 


AFPInsRemSMBParamPtr = ''AFPInsRemSMBParam; 


AFPInsRemSMBParam = RECORD 

qLi nk; OEl emPtr ; { 
qType; INTEGER; { 
ioTrap; INTEGER; { 
ioCmdAddr; Ptr; { 
ioCompletion; lOCompletionUPP ; { 
ioResult; OSErr; { 
ioNamePtr; StringPtr; { 
ioVRefNum; INTEGER; { 
ioRefNum: INTEGER; { 


csCode; INTEGER; { 

smbPtr; Ptr; { 

END; 


Standard header information ) 

Standard header information ) 

Standard header information ) 

Standard header information ) 

Completion rtn pointer ) 

Result from Async call ) 

Standard header information ) 

Standard header information ) 

RefNum of the AFPTranslator" ) 

AFPInsSessMemBlk or AFPRemSessMemBlk ) 
Pointer to the SMB to insert or remove ) 


AFPInsRemSMBPBPtr = ''AFPInsRemSMBParam; 
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AFPSrvrInfo Record 

{ Server Info Buffer returned from the dsGetStatus call ) 

{ you should make your buffer at least 1024 bytes in size.) 

{ a partial definition of the AFPSrvrInfo data structure (the fixed portion) ) 

AFPSrvrInfoPtr = ''AFPSrvrInfo: 

AFPSrvrInfo = RECORD 

fMachineOffset: INTEGER; 

fVerCountOffset: INTEGER; 

fUAMCountOffset: INTEGER; 

fIconOffset: INTEGER; 

fFlags: INTEGER: 

fSrvrName: PACKED ARRAY [0..1] OF UlntS; 

END: 

{ definitions for the fFlags word) 

CONST 

srvSCopyFile = 0; ( Server supports FPCopyFile call ) 

srvSChangePswd = 1; ( Server supports FPChangePassword call ) 

srvNoPswdSave = 2; ( Workstation should not save password ) 

srvSServerMsgs = 3; ( Server supports server messages ) 

srvSSrvrSig = 4; ( Server supports Server Signatures (AFP 2.2) ) 

srvSupportsTCP = 5; ( Server may be connected to via TCP/IP (AFP 2.2) ) 

srvSNotification = 6; ( Server will send notifications (AFP 2.2) ) 

Gestalt Selectors and Definitions 

gestaltAFPClient = 'afps'; 

gestaltAFPClientVersionMask = SOOOOFFFF; { low word is version ) 


gestaltAFPClient3_5 

= 1 




gestaltAFPClient3_6 

= 2 




gestaltAFPClient3_6_l 

= 3 




gestaltAFPClient3_6_2 

= 4 




gestaltAFPClient3_6_3 

= 5 



including 3.6.4, 3.6.5 ) 

gestaltAFPClient3_7 

= 6 



including 3.7.1 ) 

gestaltAFPClient3_7_2 

= 7 



including 3.7.3 ) 

gestaltAFPClient3_8 

= 8 




gestaltAFPClientCfgMask 

= $FFFF0000: 

high word is config ) 

gestaltAFPClientCfgRsrc 

= 16: 


Client uses config resources ) 

gestaltAFPClientUAMv2 

= 28: 

( Client 

supports the 2.0 DAM interfaces 
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gesta' 

ItAFPClientSupportsIP 

= 29; 

gesta' 

ItAFPClientVMUI 

= 30; 

gesta' 

1 tAFPClientMultiReq 

= 31; 


{ Client supports AFP over TCP/IP ) 

{ Client can put up UI from the PBVolMount 1 
{ trap ) 

{ Client supports multiple outstanding 
{ requests ) 


Routines 

FUNCTION NAFPCommandASynclparamBlock; DSParamBlockPtr); OSErr; 
FUNCTION NAFPCommandlmmediatelparamBlock; DSParamBlockPtr); OSErr; 
FUNCTION NAFPCommandSyncIparamBlock; DSParamBlockPtr); OSErr; 

I/O Completion Routine 

TYPE 

DSIOCompletionProcPtr = Register68kProcPtr; 

{ PROCEDURE DSIOCompletionIpb; UNIV Ptr); ) 

DSIOCompletionUPP = UniversalProcPtr; 


C Summary 


Constants 


enum { 


afpGetAttnRoutine 

= 252, 

dsOpenSession 

= 244, 

dsGetStatus 

= 243, 

dsSendRequest 

= 240, 

dsCloseSession 

= 237, 

dsCloseAl1 

= 232, 

AFPInsSessMemBlk 

= 246, 


/* PBControl calls */ 
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AEPPemSessMemBlk 

): 

= 245 

enutn { 

/* PBStatus calls */ 

afpGetESID 

= 127, 

afpSVolInfo 

= 124, 

afpXGetVolInfo 

= 121, 

dsGetXPortInfo 

= 236 


): 


enutn { 

SMBSize = 2560 /* size of the session memory block*/ 

): 


Data Types 


Send Request Parameter Block Structure 

/* csCode = dsSendRequest*/ 
struct DSWritePB { 

UInt32 dsWriteDataOffset;/* Specifies the write offset in the data */ 

UInt32 dsWriteBufferSize:/* Size of the data to be written */ 

Byte * dsWriteBuffer: /* Pointer to data to be written */ 


): 

typedef struct DSWritePB DSWritePB: 


Get Status Parameter Block Structure 


/* csCode = dsGetStatus*/ 
struct DSGetStatusPB { 

OTAddress * dsGSSrvrAddress: 


const char * dsGSEpString; 


/* Of address of server to GetStatusi) from */ 

/* (you also need to fill in the reply buffer */ 
/* and size) */ 

/* Endpoint string for the connection; 

/* (nil == default) */ 


typedef struct DSGetStatusPB DSGetStatusPB; 
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Open Session Parameter Block 


/* csCode = dsOpenSession*/ 


struct DSOpenPB { 
AttnRoutineUPP 
OTAddress * 

Ptr 

const char * 


dsOSAttnRoutine; 
dsOSSrvrAddress ; 
dsOSSessionBlock; 

dsOSEpString; 


/* Custom attention routine (nil == default) */ 
/* OT address of server to open a session to */ 
/* Pointer to the SMB reserved for */ 

/* the session */ 

/* Endpoint string for the connection: */ 

/* (nil == default) */ 


typedef struct DSOpenPB DSOpenPB; 


enum ) 

SMBSize = 2560 /* Size of the session memory block */ 

1 ; 


DSParamBlock Structure 


struct DSParamBlock { 


QElem * 

qLi nk; 

/* 

short 

qType; 

/* 

short 

ioTrap; 

/* 

Ptr 

ioCmdAddr; 

/* 

DSIOCompletionUPP 

ioCompletion; 

/* 

OSErr 

ioResult; 

/* 

1 ong 

cmdResult; 

/* 

short 

ioVRefNum; 

/* 

short 

ioCRefNum; 

/* 

short 

csCode; 

/* 

short 

dsTimeout; 

/* 

short 

dsReservedl; 

/* 

1 ong 

dsRetry; 

/* 

uintie 

dsReserved2; 

/* 

short 

dsSessRefNum; 

/* 

short 

dsReserveda; 

/* 

short 

dsCmdBufferSize; 

/* 

Uinta * 

dsCmdBuffer; 

/* 

UInt32 

dsReplyBufferSize; 

/* 

Uinta * 

dsReplyBuffer; 

/* 


union { 


Reserved */ 

Reserved */ 

Reserved */ 

Reserved */ 

Completion routine */ 

Result code */ 

Command result */ 

Reserved */ 

.AEPTranslator driver reference number*/ 
DS Command code */ 

Timeout (AppleTalk only) */ 

Reserved */ 

Retry count (AppleTalk only) */ 

Reserved */ 

AEP session number*/ 

Reserved */ 

Size of the command buffer */ 

Pointer to the command buffer */ 

Size of the reply buffer */ 

Pointer to the reply buffer */ 
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DSOpenPB open; /* csCode is dsOpenSession */ 

DSWritePB write: 

DSGetStatusPB status: /* csCode is dsGetStatus */ 

) csParam: 

): 

typedef struct DSParamBlock DSParamBlock: 
typedef DSParamBlock *DSParamBiockPtr: 

DSXPortInfo Structure 

struct DSXPortInfo { 

long dsXPortType: /* Transport type (kASPXport, kTCPXport) */ 

short dsXPortSessRefNum: /* Session reference number for ASP or TCP */ 

union { 

InetAddress ipAddr: 

DDPAddress ddpAddr: 

) addr: 

): 

typedef struct DSXPortInfo DSXPortInfo: 
typedef DSXPortInfo *DSXPortInfoPtr: 

/* definitions for dsXPortType */ 
enum { 

kASPXport = 0x00, 

kTCPXport = 0x01 


GetVolSessInfoRec Structure 

struct GetVolSessInfoRec { 


short 

sessAFPVersion: 

/* 

AFP version number */ 

short 

sessReferenceNumber: 

/* 

AFP session reference number */ 

short 

sessAFPVolID: 

/* 

AFP volume identifier */ 

OTAddress * 

sessServerAddress: 

/* 

Server internet address */ 

short 

sessUAMType: 

/* 

User authentication method */ 

StringPtr 

sessUserNamePtr: 

/* 

Pointer to user name string */ 

Ptr 

sessVolIconPtr: 

/* 

Pointer to server volume icon/mask */ 

StringPtr 

sessWhereStringPtr: 

/* 

Pointer to ''where'' information */ 



/* 

string shown in the Get Info window */ 
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1 ; 

typedef struct GetVolSessInfoRec GetVolSessInfoRec; 
typedef GetVolSessInfoRec *GetVolSessInfoRecPtr; 


enum { 

kAFPVersionll = 1, 

kAFPVersion20 = 2, 

kAFPVersion21 = 3, 

kAFPVersion22 = 4 

1 ; 


enum 


kNoUserAuth 

= 1, 

/* 

'No User Authent' 

UAM 

(Guest)*/ 


kClea rtextAuth 

= 2, 

/* 

'Cleartxt Passwrd' 

UAM 

(types 2 

& 3 will 



/* 

automatically upgraded 

to 6)*/ 


kPandnumAuth 

= 3, 

/* 

'Randnum Exchange' 

UAM 

*/ 


kSWayPandnumAuth 

= 6, 

/* 

'2-Way Randnum exchange' */ 


kMinCustomUAM 

= 128 

/* 

Minimum type value 

for 

a Custom 

UAM*/ 


be */ 


GetVolSessInfoPB Structure 

struct GetVolSessInfoPB { 


QEl emPtr 

qLi nk; 

/* 

Standard header information */ 

short 

qfype; 

/* 

Standard header information */ 

short 

ioTrap; 

/* 

Standard header information */ 

Ptr 

ioCmdAddr; 

/* 

Standard header information */ 

lOCompletionUPP 

ioCompletion; 

/* 

Completion routine pointer */ 

OSErr 

ioResult; 

/* 

Result from Async call */ 

StringPtr 

ioNamePtr; 

/* 

Standard header information */ 

short 

ioVRefNum; 

/* 

Standard header information */ 

short 

ioRefNum; 

/* 

RefNum of the ".AFPTranslator" */ 

short 

csCode; 

/* 

Always afpSVolInfo */ 

Ptr 

vcbPtr; 

/* 

Pointer to the VCB that you want */ 



/* 

information about */ 

GetVolSessInfoRecPtr 

' sessInfoBuffer; 

/* 

Pointer to the GetVolSessInfoRec to */ 



/* 

be filled */ 

1 ong 

sessInfoSize; 

/* 

Size of the GetVolSessInfoRec */ 

1 ong 

actSessInfoSize; 

/* 

Actual size of the data returned */ 
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): 

typedef struct GetVolSessInfoPB GetVolSessInfoPB; 

typedef GetVolSessInfoPB *GetVolSessInfoPBPtr; 

/* the AFPInsSessMemBIk & AFPRemSessMemBlk calls are currently (pre Client 3.8) 
required when opening or closing a session. Make the AFPInsSessMemBIk call after 
the dsOpenSession call succeeds (or returns afpAuthContinue), with the same 
dsOSSessionBlock that you sent into dsOpenSession. You need to call 
AFPRemSessMemBlk with that same pointer after calling dsCloseSession or dsCloseAll. 
In Client 3.8 these will be called for you during the dsOpenSession & 
dsCloseSession calls. 

*/ 


AFPInsRemSMBParam Structure 

struct AFPInsRemSMBParam { 


OEl emPtr 

qbi nk; 

/* 

Standard header information 

*/ 

short 

qfype; 

/* 

Standard header information 

*/ 

short 

ioTrap; 

/* 

Standard header information 

*/ 

Ptr 

ioCmdAddr; 

/* 

Standard header information 

*/ 

lOCompletionUPP 

ioCompletion; 

/* 

Completion routine pointer*/ 


OSErr 

ioResult: 

/* 

Result from Async call*/ 


StringPtr 

ioNamePtr; 

/* 

Standard header information 

*/ 

short 

ioVRefNum; 

/* 

Standard header information 

*/ 

short 

ioRefNum; 

/* 

RefNum of the ".AFPTranslator" */ 

short 

csCode; 

/* 

AFPInsSessMemBIk or AFPRemSessMemBlk * 

Ptr 

smbPtr; 

/* 

Pointer to the SMB to insert 

or remove 


1 : 

typedef struct AFPInsRemSMBParam AFPInsRemSMBParam; 
typedef AFPInsRemSMBParam *AFPInsRemSMBPBPtr; 

AFPSrvrInfo Structure 

/* Server Info Buffer returned from the dsGetStatus call */ 

/* you should make your buffer at least 1024 bytes in size.*/ 

/* a partial definition of the AFPSrvrInfo data structure (the fixed portion) */ 

struct AFPSrvrInfo { 

short fMachineOffset: 

short fVerCountOffset; 
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short fUAMCountOffset; 

short fIconOffset; 

short fFlags; 

unsigned char fSrvrName[2]; 

1 ; 

typedef struct AFPSrvrInfo AFPSrvrInfo; 

/* Definitions for the fFlags word*/ 
enum { 

srvSCopyFile = 0, /* Server supports FPCopyFile call */ 

srvSChangePswd = 1, /* Server supports FPChangePassword call */ 

srvNoPswdSave = 2, /* Workstation should not save password */ 

srvSServerMsgs = 3, /* Server supports server messages */ 

srvSSrvrSig = 4, /* Server supports Server Signatures (AFP 2.2) */ 

srvSupportsTCP = 5, /* Server may be connected to via TCP/IP (AFP 2.2) */ 

srvSNotification =6 /* Server will send notifications (AFP 2.2) */ 


Gestalt Selectors and Definitions 


enum { 

gestaltAFPClient = F0UR_CHAR_C0DE('afps'), 

gestaltAFPClientVersionMask = OxOOOOFFFF, /* Low word is version*/ 

gestaltAFPClient3_5 = 1, 

gestal tAFPClient3_6 = 2, 

gestaltAFPClient3_6_l = 3, 

gestaltAFPClient3_6_2 = 4, 

gestaltAFPClient3_6_3 = 5, /* Including 3.6.4, 3.6.5 */ 

gestaltAFPClient3_7 = 6, /* Including 3.7.1 */ 

gestaltAFPClient3_7_2 = 7, /* Including 3.7.3 */ 

gestaltAFPClient3_8 = 8, 

gestaltAFPClientCfgMask = (1ong)OxFFFFOOOO,/* high word is config */ 
gestaltAFPClientCfgRsrc = 16, /* Client uses config resources */ 

gestaltAFPClientUAMv2 = 28, /* Client supports the 2.0 UAM interfaces */ 

gestaltAFPClientSupportsIP = 29, /* Client supports AFP over TCP/IP */ 

gestaltAFPClientVMUI = 30, /* Client can put up UI from the */ 

/* PBVolMount trap */ 

gestaltAFPClientMultiReq = 31 /* Client supports multiple outstanding */ 



requests 


*/ 


46 


Summary of AFP 




CHAPTER 1 


AppleTalk Filing Protocol (AFP) 


Routines 

OSErr NAFPCotntnandAsync( DSParamBl ockPtr paratnBl ock); 

OSErr NAEPCommandlmtiiedi ate( DSParamBl ockPtr paramBlock); 

OSErr NAEPCommandSync(DSParamBlockPtr paramBlock); 

I/O Completion Routine 

typedef CALEBACK_API( void , DSIOCompletionProcPtr )(void *pb): 

/* 

WARNING: DSIOCompletionProcPtr uses register based parameters under classic 68k 
and cannot be written in a high-level language without 
the help of mixed mode or assembly glue. 

*/ 

typedef REGISTER_UPP_TYPE(DSIOCompletionProcPtr) DSIOCompletionUPP; 

Assembly-Language Summary 


Constants 


DS Control Codes 


afpXGetVolInfo 

EOU 

121 

afpSVolInfo 

EOU 

124 

afpGetFSID 

EOU 

127 

dsCl oseAl1 

EOU 

232 

dsGetXPortInfo 

EOU 

236 

dsCl oseSession 

EOU 

237 

dsSendRequest 

EOU 

240 

dsGetStatus 

EOU 

243 

dsOpenSession 

EOU 

244 
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AFPRemSessMemBlk 

EQU 

245 

AFPInsSessMemBlk 

EQU 

246 

afpGetAttnRoutine 

EQU 

252 

Miscellaneous 




SMBSize EQU 2650 ;size of the session memory block 


Data Structures 


Send Request Parameter Block 

; csCode = dsSendRequest 
DSWritePB RECORD 0 


dsWriteDataOffset 

ds. 1 

1 

offset: 

$0 

(0); 

Specifies the write offset in the 
data 

dsWriteBufferSize 

ds. 1 

1 

offset: 

$4 

(4) ; 

Size of the data to be written 

dsWriteBuffer 

ds. 1 

1 

offset: 

$8 

(8) ; 

Pointer to data to be written 

sizeof 

EQU * 


size; 

$C 

(12) 


ENDR 







Get Status Parameter Block 





; csCode = dsGetStatus 






DSGetStatus PB 


RECQRD 0 




dsGSSrvrAddress 

ds. 1 

1 

offset: 

$0 

(0) ; 

QT address of server to GetStatus() 




from (you 

al so 

need to fill in the reply buffer and 




size) 




dsGSEpString 

ds. 1 

1 

offset: 

$4 

(4) ; 

Endpoint string for the connection 




(nil == 

default) 

sizeof 

EQU * 


size; 

$8 

(8) 



ENDR 


48 


Summary of AFP 






CHAPTER 1 


AppleTalk Filing Protocol (AFP) 


Open Session Parameter Block 

: csCode = dsOpenSession 


DSOpenPB 

RECORD 0 




dsOSAttnRoutine 

ds. 1 

; offset; 

$0 

(0) 

dsOSSrvrAddress 

ds.l 1 

; offset; 

$4 

(4) 

dsOSSessionBlock 

ds.l 1 

; offset; 

CO 

(8) 

dsOSEpString 

ds.l 1 

; offset; 

$c 

(12) 

sizeof 

EQU * 


size: 


DSParamBlock Parameter Block 


DSParamBlock 

RECORD 0 




qLi nk 

ds. 1 

offset 

$0 

(0) ; 

qType 

ds .w 

offset 

$4 

(4) ; 

ioTrap 

ds .w 

offset 

$6 

(6) ; 

ioCmdAddr 

ds. 1 

offset 

CO 

(8) ; 

ioCompletion 

ds. 1 

offset 

$c 

(12) ; 

ioResult 

ds .w 

offset 

$10 

(16) ; 

cmdResult 

ds. 1 

offset 

$12 

(18) ; 

ioVRefNum 

ds .w 

offset 

$16 

(22) ; 

ioCRefNum 

ds .w 

offset 

$18 

(24) ; 

csCode 

ds .w 

offset 

$1A 

(26) ; 

dsTimeout 

ds .w 

offset 

$1C 

(28) ; 

dsReservedl 

ds .w 

offset 

$1E 

(30) ; 

dsRetry 

ds. 1 

offset 

$20 

(32) ; 

dsReservedS 

ds .w 

offset 

$24 

(36) ; 

dsSessRefNum 

ds. w 

offset 

$26 

(38) ; 

dsReservedS 

ds .w 

offset 

$28 

(40) ; 

dsCmdBufferSize 

ds. w 

offset 

$2A 

(42) ; 

dsCmdBuffer 

ds. 1 

offset 

$2C 

(44) ; 

dsReplyBufferSize 

ds. 1 

offset 

$30 

(48) ; 

dsReplyBuffer 

ds. 1 

offset 

$34 

(52) ; 

open 

ds DSOpenPB 

offset; $38 


; Custom attention routine 
: (nil == default) 

; OT address of server to open a 
: session to 

; Pointer to the SMB reserved 
: for the session 
; Endpoint string for the 
: connection (nil == default) 

$10 (16) 


Standard header information 
Standard header information 
Standard header information 
Standard header information 
Completion routine pointer 
Result from Async call 
Result from the server for the AFP 
command 

Standard header information 
RefNum of the . AFPTransl ator” 

DS command code 

Reserved for TCP; for ASP, how long 
to wait before retrying the request 
Reserved 

Unused for TCP; for ASP, how many 
times to retry the request 
Reserved 

AFP session number 
Reserverd 

Size of the command buffer 
Pointer to the command buffer 
Size of the reply buffer 
Pointer to the reply buffer 
(56) ORG 56 
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wri te 

ds 

DSWritePB; offset; $38 

(56) ORG 56 

status 

ds 

DSGetStatusPB; offset; 

$38 (56) ORG 72 

sizeof 

EQU * 


size; $48 (72) 



ENDR 








DSXPortInfo Record 







DSXPortInfo RECORD 0 







dsXPortType 

ds. 1 

1 


offset 

$0 (0); 

Transport Type (kASPXport, 
kTCPXport) 

dsXPortSessRefNum 

ds .w 

1 


offset 

; $4 (4) 

Session ref number for ASP or 

ipAddr 

ds 

InetAddress 

; offset 

$6 (6) 


ORG 6 







ddpAddr 

ds 

DDPAddress 

; offset 

$6 (6) 


ORG 22 







sizeof 

EOU * 




size; 

$16 (22) 

ENDR 








; definitions for dsXPortType 






kASPXport 

EOU 


$00 




kTCPXport 

EOU 


$01 




GetVolSessInfo Record 







GetVolSessInfoPecRECORD 0 







sessAFPVersion 

ds .w 

1 


offset 

$0 (0) 


AFP version number; 

sessRefepenceNumber 

ds .w 

1 


offset 

$2 (2) 


AFP session reference number 

sessAFPVolID 

ds .w 

1 


offset 

$4 (4) 


AFP volume identifier 

sessServerAddress 

ds. 1 

1 


offset 

$6 (6) 


Server internet address 

sessUAMType 

ds .w 

1 


offset 

$A (10) 


User authentication method 

sessUserNamePtr 

ds. 1 

1 


offset 

$C (12) 


Pointer to user name string 

sessVolIconPtr 

ds. 1 

1 


offset 

$10 (16) 


Pointer to server volume icon/ 

mask 

sessWhereStringPtr 

ds.ll 



offset 

$14 (20) 


ptr to "where" information 
string shown in the Get Info 

window 

sizeof 

EOU * 



size; 

$18 (24) 




ENDR 
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kAFPVersionll EQU 1 

kAFPVersion20 EQU 2 

kAFPVersion21 EQU 3 

kAFPVersion22 EQU 4 

kNoUserAuth EQU 1 : 'No User Authent' UAM (Guest) 

kCleartextAuth EQU 2 ; 'Cleartxt Passwrd' UAM (types 2 & 3 will be 

: automatically upgraded to 6) 
kRandnumAuth EQU 3 ; 'Randnum Exchange' UAM 

k2WayRandnumAuth EQU 6 : '2-Way Randnum exchange' 

kMinCustomUAM EQU 128 : Minimum type value for a Custom UAM 


GetVolSessionPB Record 

GetVol SessInfoPBRECQRD 0 


qti nk 

ds. 1 

qfype 

ds .w 

ioTrap 

ds .w 

ioCmdAddr 

ds. 1 

ioCompletion 

ds. 1 

ioResult 

ds .w 

ioNamePtr 

ds. 1 

ioVRefNum 

ds .w 

ioRefNum 

ds .w 

csCode 

ds .w 

vcbPtr 

ds. 1 

sessInfoBuffer 

ds. 1 

sessInfoSize 

ds. 1 

actSessInfoSize 

ds. 1 

sizeof 

EQU 

ENDR 



1 

offset 

$0 (0) 

1 

offset 

$4 (4) 

1 

offset 

$6 (6) 

1 

offset 

$8 (8) 

1 

offset 

$C (12) 

1 

offset 

$1Q (16) 

1 

offset 

$12 (18) 

1 

offset 

$16 (22) 

1 

offset 

$18 (24) 

1 

offset 

$1A (26) 

1 

offset 

$1C (28) 

1 

offset 

$2Q (32) 

1 

offset 

$24 (36) 

1 

offset 

$28 (4Q) 


size: 

$2C (44) 


Standard header stuff 
Standard header stuff 
Standard header stuff 
Standard header stuff 
Completion rtn pointer 
Result from Async call 
Standard header stuff 
Standard header stuff 
RefNum of the ".AFPTranslator" 

Always afpSVolInfo 

Pointer to the VCB that you want info 
about 

Pointer to the GetVolSessInfoRec to 
be filled 

Size of the GetVolSessInfoRec 
Actual size of the data returned 


AFPInsRemSMBParam Record 

; The AFPInsSessMemBlk & AFPRemSessMemBlk calls are currently 

: required when opening or closing a session. Make the AFPInsSessMemBlk call after the 
: dsQpenSession call succeeds (or returns afpAuthContinue), with the same 
: dsQSSessionBlock that you sent into dsQpenSession. You need to call AFPRemSessMemBlk 
: with that same pointer after calling dsCloseSession or dsCloseAll. 


Summary of AFP 


51 










CHAPTER 1 


AppleTalk Filing Protocol (AFP) 


AFPInsRemSMBParamRECORD 0 


qLi nk 

ds. 1 

1 

offset 

$0 (0) 

qType 

ds .w 

1 

offset 

$4 (4) 

ioT rap 

ds .w 

1 

offset 

$6 (6) 

ioCmdAddr 

ds. 1 

1 

offset 

$8 (8) 

ioCompletion 

ds. 1 

1 

offset 

$C (12) 

ioResult 

ds .w 

1 

offset 

$10 (16) 

ioNamePtr 

ds. 1 

1 

offset 

$12 (18) 

ioVRefNum 

ds .w 

1 

offset 

$16 (22) 

ioRefNum 

ds .w 

1 

offset 

$18 (24) 

csCode 

ds .w 

1 

offset 

$1A (26) 

smbPtr 

ds. 1 

1 

offset 

$1C (28) 


sizeof EQU * ; size; $20 (32) 

ENDR 


Standard header stuff 

Standard header stuff 

Standard header stuff 

Standard header stuff 

Completion rtn pointer 

Result from Async call 

Standard header stuff 

Standard header stuff 

RefNum of the ".AFPTranslator" 

AFPInsSessMemBlk or AFPRemSessMemBlk 

Pointer to the SMB to insert or 

remove 


AFPSrvrInfo Record 

; Server Info Buffer returned from the dsGetStatus call 
; you should make your buffer at least 1024 bytes in size. 

; a partial definition of the AFPSrvrInfo data structure (the fixed portion) 

AFPSrvrInfo RECORD 0 

fMachineOffset ds.w 1 

fVerCountOffset ds.w 1 

fUAMCountOffset ds.w 1 

fIconOffset ds.w 1 

fFlags ds.w 1 

fSrvrName ds.b 2 

sizeof EQU * 

ENDR 


; definitions for 

the 

fFlags word 



s rvSCopyFi1e 

EQU 

0 

Server 

supports FPCopyFile call 


s rvSChangePswd 

EQU 

1 

Server 

supports FPChangePassword call 


s rvNoPswdSave 

EQU 

2 

Workstation should not save password 


s rvSServerMsgs 

EQU 

3 

Server 

supports server message 


srvSSrvrSig 

EQU 

4 

Server 

supports Server Signatures (AFP 2.2) 

s rvSupportsTCP 

EQU 

5 

Server 

may be connected to via TCPIP 

(AFP 2.2) 

srvSNotificationEQU 


6 

Server 

will send notifications (AFP 2 

.2) 
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Gestalt Selectors and Definitions 


gesta 

tAFPClient 

FQU 

'afps' 


gesta 

tAFPClientVersionMask 

FQU 

SOOOOFFFF 

Low word is version 

gesta 

tAFPClient3_5 

FQU 

1 


gesta 

tAFPClient3_6 

FQU 

2 


gesta 

tAFPClient3_6_l 

FQU 

3 


gesta 

tAFPClient3_6_2 

FQU 

4 


gesta 

tAFPClient3_6_3 

FQU 

5 

Including 3.6.4, 3.6.5 

gesta 

tAFPClient3_7 

FQU 

6 

Including 3.7.1 

gesta 

tAFPClient3_7_2 

FQU 

7 

Including 3.7.3 

gesta 

tAFPClient3_8 

FQU 

8 


gesta 

tAFPClientCfgMask 

FQU 

$FFFFQQQQ 

High word is config 

gesta 

tAFPClientCfgRsrc 

FQU 

16 

Client uses config resources 

gesta 

tAFPClientUAMv2 

FQU 

28 

Client supports 2.Q UAM interfaces 

gesta 

tAFPClientSupportsIP 

FQU 

29 

Client supports AFP over TCP/IP 

gesta 

tAFPClientVMUI 

FQU 

3Q : Client 

can put up UI from the PBVolMount trap 

gesta 

tAFPClientMultiReq 

FQU 

31 ; Client 

supports multiple outstanding requests 


Result Codes 


kFPAccessDenied 

-5000 

The client does not have permission to 
perform the specified command. 

kFPAuthConti nue 

-5001 

The clienf should perform fhe nexf 
aufhenficafion sfep. 

kFPBadUAM 

-5002 

The specified UAM does nof exisf. 

kFPBadVersNuni 

-5003 

The server does nof supporf fhe 
specified version number. 

kFPBi tniapErr 

-5004 

The specified bifmap specifies an invalid 
value. 

kFPCantMoveErr 

-5005 

Can'f move a file or folder from one 
direcfory fo anofher. Superuser frying fo 
move one share poinf info anofher. 

kFPDenyConf1ict 

-5006 

User opens file and denies wrife, 
anofher opens fo wrife. 

kFPDi rNotEnipty 

-5007 

The command fo remove a direcfory 
could nof be complefed because fhe 
direcfory is nof empfy. 

The command could nof be complefed 
because fhe disk is full. 

kFPDiskFull 

-5008 
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kFPEOFErr 

kFPFi1eBusy 

kFPFlatVol 

kFPItemNotFound 

kFPLockErr 
kFPMiscErr 
kFPNoMoreLocks 
kFPNoServer 


kFPObj ectExists 
kFPObj ectNotFound 
kFPPa ramErr 


kFPRangeNotLocked 

kFPRangeOverLap 

kFPSessClosed 

kFPUserNotAuth 


kFPCallNotSupported 

kFPObj ectTypeErr 
kFPTooManyFi1esOpen 


kFPServerGoingDown 
kFPCantRename 

kFPDirNotFound 

kFPIconTypeErr 
kFPVolLocked 


kFPObj ectLocked 

kFPContainsSharedErr 

kFPIDNotFound 
kFPIDExists 
kFPDiffVolErr 


-5009 Returned by the FPCatSearch command 
when there are no more matches. 

-5010 The specified file is in use. 

-5011 Obsolefe as of AppleShare IP 6.0. 

-5012 The specified file or direcfory could nof 
be found. 

-5013 The specified file is locked. 

-5014 A unspecified error occurred. 

-5015 All of fhe available locks are in use. 

-5016 There is nof a server af fhe specified 
server address, or fhe server did nof 
respond fo fhe requesf. 

-5017 The specified objecf already exisfs. 

-5018 The specified objecf could nof be found. 

-5019 The paramefer block confains dafa fhaf 
is invalid for fhe specified AFP 
command. 

-5020 The specified range could nof be locked. 

-5021 The specified range confains 

overlapping values. 

-5022 The specified command could nof be 

complefed because fhe session is closed. 

-5023 The command could nof be performed 
because fhe clienf has nof been 
aufhenficafed. 

-5024 The specified command is nof 

supporfed. 

-5025 The specified objecf is fhe wrong fype. 

-5026 The specified command could nof be 
complefed because too many files are 
open. 

-5027 The server is shutting down. 

-5028 The specified file or direcfory cannof be 
renamed. 

-5029 The specified direcfory could nof be 
found. 

-5030 The specified icon is of fhe wrong fype. 

-5031 The specified command could nof be 
complefed because fhe volume is 
locked. 

-5032 The specified command could nof be 
complefed because fhe objecf is locked. 

-5033 The specified share poinf confains a 
share poinf. 

-5034 The specified ID could nof be found. 

-5035 The specified ID already exisfs. 

-5036 Equivalenf fo fhe Mac OS error code. 
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kFPCatalogChanged 

-5037 

The catalog has changed and CatPosition 
may be invalid. No matches were 
returned. 

kFPSanieObjectErr 

-5038 

Equivalent to the Mac OS error code. 

kFPBadIDFrr 

-5039 

The specified ID is invalid. 

kFPPwdSanieFrr 

-5040 

The new password is the same as the 
old password. 

kFPPwdTooShortFrr 

-5041 

The specified password is foo shorf. 

The passworcThas expired. 

kFPPwdExpiredErr 

-5042 

kFPInsideSharedErr 

-5043 

The specified direcfory is inside a share 

kFPInsideTrashErr 

-5044 

poinf. 

The specified direcfory is in fhe Trash. 

kFPPwdNeedsChangeErr 

-5045 

The password needs fo be changed fhe 
firsf time fhe user logs on. 

kFPPwdPolicyErr 

-5046 

The specified password violafes a 
UAM's policy. 
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